home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
maximus
/
tcall110.zip
/
TCALL.DOC
next >
Wrap
Text File
|
1992-10-17
|
5KB
|
115 lines
TCall v1.10
October 17, 1992
Copyright (c) 1992 by Mark R. Evans
All Rights Reserved.
LICENSE
-------
Permission granted to use this program, and distribute it to others.
The original documentation and program must be distributed in
unmodified form. For information, contact the author at FidoNet
1:382/91.1, or P. O. Box 163611, Austin, TX 78716, USA.
WARRANTY AND STATEMENT OF LIABILITY
-----------------------------------
TCALL does not carry any warranty of any kind, including that of
fitness for any particular purpose. You use TCALL at your own risk.
If it causes damage to your hard disk, your life, your marriage, etc.,
you take full responsibility. You acknowledge this in full by using
TCALL. TCALL is not licensed for legal use in any jurisdiction where
local or regional law renders this Warranty and Statement of Liability
invalid.
COST
----
TCALL is free. Use it for free, distribute it for free. You may not
charge any fee for distribution of TCALL.
DESCRIPTION
-----------
TCALL is a program that will create a bulletin listing everyone who
has called your Maximus-CBCS v2.x BBS today and/or yesterday. TCall
differs from other call listers in that it does not read the USER.BBS
file, instead it looks at the LASTUS##.BBS file to build the caller
list. This allows TCall to show _every_ call to your BBS. TCall was
designed to be flexible enough to serve everyone's needs. Some
features of TCall are:
o Can use Real Names, Aliases, or Both
o Optionally exclude calls from the Sysop
o Ability to run in a multitasking environment
o Optionally display the previous days callers
o Bound application so it can run under DOS or OS/2
o On-line times and download bytes are 100% accurate per call
USAGE
-----
TCALL _MUST_ be run from the same directory where Maximus is stored.
TCALL uses the following command line parameters:
Usage: TCALL [options]
-s DO NOT include calls from Sysop.
-n Task/Node Number to use. (REQUIRED).
-t Title for bulletin, if this contain spaces, it _MUST_ be
enclosed in quotes! Default is no title.
-r Use RealNames (default).
-a Use Alias names.
-o Directory to place the TCALL##.BBS Bulletin.
-y Add yesterday's stats to bulletin.
-u Only update the bulletin, do not write to data file!
Note: Both -r and -a can be used to display both real and alias names.
Note: If you specify -a (alias names), then real names WILL NOT be
displayed.
Example: TCALL -n1 -t"BBS Name Here" -r -a -y
TCall requires that the -n switch be used. I suggest that you place
TCall in your RUNBBS.BAT (or whatever you call yours) batch file to
execute after each caller. TCall will update it's data files and
generate the caller bulletin.
To display the bulletin, add a new menu item using the following
format:
Display_File TCall%K SysOp "Today's Callers"
The %K is translated by Maximus-CBCS to the current TASK number.
To display this bulletin at the local console, you can use ORACLE to
view it as follows:
ORACLE TCall##
Replace the ## with the task number that your BBS is using.
HOW DOES IT WORK?
-----------------
After each caller logs off, TCall reads the LASTUS##.BBS file, updates
it's data file (TCALL##.DAT) and generates the bulletin file
(TCALL##.BBS). Also, TCall will check the current system date to the
TCALL##.DAT file, if the dates are different (implying we have passed
midnight), TCall will rename it's data file to TCALL##.YES and create
a new TCALL##.DAT file. This allows you to see both today's callers
as well as yesterdays callers. TCall also uses a file called
TCLOK.DAT for locking the data records in a multi-user environment.
Note: ## is replaced by the task number specified with the -n switch.
BUGS, ANOMALIES, PROBLEMS
-------------------------
There is one know minor anomaly that you should be aware of:
1. Each time you run TCALL without the -u switch, it will read the
LASTUS##.BBS file and add another record to the TCALL##.DAT file.
If you just want to re-generate the .BBS file (possibly changing
the title or adding yesterdays info), without updating the data
file, you MUST use the -u command line switch.